home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 3 / The Pier Shareware Number 3 (The Pier Exchange) (1993).iso / thepier / thepier.doc < prev    next >
Text File  |  1993-09-20  |  9KB  |  166 lines
  1.  
  2.            ThePier v2.0 - High Performance CD-ROM Access
  3.  
  4.     Copyright (c) 1993 RoboSoft Systems.  All rights reserved.
  5.  
  6.  
  7. Congratulations  on your purchase of a The Pier Shareware CD-ROM,
  8. the  finest  shareware  CD-ROMs  available  in the world. ThePier
  9. CD-ROM Access  program  will  assist you in finding files on your
  10. CD-ROM and performing common operations on those files.
  11.  
  12. If you  haven't already  installed ThePier access program, please
  13. do so by changing directories to the root directory (for example,
  14. E:\) of your The Pier  Shareware  CD-ROM and typing INSTALL.  The
  15. install  program  will copy  ThePier  access  program  and  a few
  16. support  files  to a  directory on your  hard disk.  You can then
  17. change to the  directory  where  ThePier  was  installed and type
  18. ThePier to start the access program.
  19.  
  20. You should find  ThePier very easy  and intuitive to operate, but
  21. there are a few important  features that aren't  obvious so we'll
  22. do a quick walk-through of the program and discuss these features
  23. along the way.
  24.  
  25. ThePier  is designed to use the  best  available  video mode your
  26. computer will  support.  By default,  it will try to use graphics
  27. mode  (EGA or VGA required)  and  resort to text mode if graphics
  28. mode is unavailable. If for some reason you have problems viewing
  29. the screens in graphics mode, you can force the program into text
  30. mode by using a /T  parameter on the command  line  (i.e. ThePier
  31. /T).  Graphics  mode  also  requires  the  file  EGAVGA.BGI to be
  32. present in the directory where ThePier.EXE resides.  (The install
  33. program will put it there.)  If this file isn't present,  ThePier
  34. will use a text mode display.
  35.  
  36. The first screen  you see when you start ThePier is a list of the
  37. subjects  available  on  your  The Pier Shareware CD-ROM.  If you
  38. have a  mouse on your  system, a mouse pointer will be displayed.
  39. You can use  the mouse to click on any of the subjects, the items
  40. on the menu bar on the top of the screen, or on the scroll bar to
  41. the right of the screen. If you click on a subject, a list of the
  42. files in that subject will appear.
  43.  
  44. At the top of the subject screen  you'll see a drop-down menu bar
  45. containing  System,  Search,  and  Configure.   At this point the
  46. System  menu  will  allow you to Shell to DOS, keeping ThePier in
  47. memory  and  ready to go when you type EXIT at the DOS prompt, or
  48. to Exit ThePier.
  49.  
  50. The  Search  menu  will allow you to search  ThePier database for
  51. matching  file names,  keywords,  or content file names.  In this
  52. context, file names  refers to the names of the files on your The
  53. Pier Shareware  CD-ROM,  many  of them  archive  files;  keywords
  54. refers  to  significant words used in the  file descriptions; and
  55. content  file names refers to the files that are contained within
  56. the archive files.  If you  wanted to  search for  all files that
  57. might have something to do with Windows, you would select Keyword
  58. from the  search menu and type WINDOWS in the prompt box. ThePier
  59. will then  display a list of all the  files  containing  the word
  60. "windows" somewhere in their description.
  61.  
  62. The pull-down Configure menu allows you to change the operational
  63. parameters  used  by ThePier.  You can  force the display to text
  64. mode  (meaning you  wouldn't  need the  /T  on the command line),
  65. change the active  database (useful if you have more than one The
  66. Pier Shareware CD-ROM),  change  the  directories used by ThePier
  67. for temporary  files,  and set up  viewer  programs to be  called
  68. automatically  when  certain  files are  selected.  On all of the
  69. configuration  screens,  if you  press  ESCape, any  changes  you
  70. entered on that screen  will be thrown away and the old data will
  71. be restored.
  72.  
  73. The  viewers  are  one of the  nicest  features of ThePier.  They
  74. allow you to  associate  programs with data files on the basis of
  75. the data  file  extension.  The  Viewer  configuration  screen is
  76. divided  into  several areas.   At the top is the default viewer.
  77. This is the  viewer  program that is called whenever the selected
  78. file does not match one of the file  extensions specified on this
  79. screen.  ThePier has a  built-in  viewer  that  is  used  as  the
  80. default viewer unless you specify something different.  Leave the
  81. Default  Viewer  field  blank if you  want to  use  the  built-in
  82. viewer.  (The built-in viewer is designed to work only with plain
  83. ASCII text files  and  will view  only the first 32k bytes of any
  84. file.  If you plan to  view  non-ASCII files or very large files,
  85. you  will  probably  want to  specify  a different program as the
  86. default viewer.  Vern Buerg's LIST program is an excellent choice
  87. for the default viewer.)
  88.  
  89. To  specify  a  different  default  viewer,  enter what you would
  90. normally  type at the DOS command  line to  start  that  program.
  91. Where  you  would  ordinarily  type  the  name  of the file to be
  92. viewed, enter "$F"  without the quotes.  ThePier will replace the
  93. $F  with the name of the file you've selected for viewing. If you
  94. wanted to use Vern Buerg's  LIST  program as your default viewer,
  95. your default viewer line might look like:
  96.  
  97.       Default Viewer: LIST $F
  98.  
  99. The other  viewers  are all paired with a line of file extensions
  100. associated with  that  viewer.  Anytime you select a file with an
  101. extension  from  the  viewer list, the viewer program  associated
  102. with that extension will  be  executed.  The viewer command lines
  103. are just like the  Default Viewer line as far as format goes. Use
  104. $F in the command where you want the file name to go.
  105.  
  106.  
  107. Back to the subjects  screen... If you select one of the subjects
  108. by clicking on it with your  mouse  or  pressing  ENTER  when the
  109. desired subject is highlighted, you'll see a list of the files in
  110. that subject  along  with as much of the file description as will
  111. fit on a single line. At the top of this screen you'll notice the
  112. menu  bar  has  changed.  System  is  still there, though  it now
  113. contains an  additional  "Return to previous menu" item. (You can
  114. also return to the previous screen by pressing ESCape or clicking
  115. on the  little  box in the  upper left  corner  of the  file list
  116. window.)  The Search  menu is  still there  too, but its function
  117. has  changed a bit.  At this  point  searches  will not  scan the
  118. entire  database,  but will  be limited to the subject  currently
  119. selected.
  120.  
  121. If you select one of the files by  clicking on it with your mouse
  122. or  pressing  enter  when the  file  is  highlighted,  you'll see
  123. detailed  information  about that file.  In the upper left of the
  124. detail screen is the file name, location, size, and date.  In the
  125. upper right is a list of the contents of this file.  (If the file
  126. is not an archive file, you'll just see the file name again.)  In
  127. the middle of the screen is the full file description. Toward the
  128. bottom  of  the  screen  is  a  box  where you can enter your own
  129. comments  about  this  file.  These  comments  will  be saved and
  130. redisplayed  when  you view this file's detail information again.
  131. At the very bottom of the screen is a prompt bar. Pressing any of
  132. the specified  keys will perform  the indicated  action.  You can
  133. also  click  with  your  mouse  on any of the  words  to take the
  134. indicated action.
  135.  
  136. The content list in the upper right of the detail screen is where
  137. the  viewers  come  in.  If  you  select  one of the files in the
  138. content list, that  file will be  extracted  from the archive (if
  139. necessary)  and passed to the appropriate  viewer  program. If no
  140. viewer  is  associated  with the  selected  file  extension,  the
  141. default viewer will be used.  (When ThePier executes a viewer, it
  142. swaps  all  but  about  10k of  itself to  EMS or to disk, so the
  143. viewer program should have plenty of memory available.)
  144.  
  145. At the top  of the file  detail  screen  you'll see the  familiar
  146. System menu along with a File menu.  The File menu will allow you
  147. to  copy a  complete  file or to  extract an archive file. If you
  148. select  either  of  these  options,  you'll  be  prompted  for  a
  149. destination  directory for the copy or  extract  operation. These
  150. directories  will  default  to  the  Copy  and  Work  directories
  151. specified in the  configuration menu off the subjects screen. You
  152. can  change  them by  selecting a different  directory  from  the
  153. displayed  list.  If you  want  the  files to  go  to a different
  154. drive,  you'll  have  to  type the drive letter on the  directory
  155. line.
  156.  
  157. That's  about  it  for  this  brief tour of ThePier CD-ROM access
  158. program.  If you have  questions  or  comments about ThePier High
  159. Performance  CD-ROM  Access  program,  you  can  contact RoboSoft
  160. Systems at:
  161.  
  162.           RoboSoft Systems P.O. Box 2221 Orange, CA 92669
  163.  
  164.       We hope you enjoy ThePier and The Pier Shareware CD-ROM.
  165.  
  166.